home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Applications 1999 May / SGI IRIX 6.5 Applications 1999 May.iso / dist / arraysvcs.idb / usr / share / catman / u_man / cat1 / arshell.z / arshell
Text File  |  1998-10-27  |  11KB  |  199 lines
  1.  
  2.  
  3.  
  4. aaaarrrrsssshhhheeeellllllll((((1111))))                                                          aaaarrrrsssshhhheeeellllllll((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      arshell - remote shell for arrays
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaarrrrsssshhhheeeellllllll [_o_p_t_i_o_n_s...] [_u_s_e_r_n_a_m_e@]_h_o_s_t _c_o_m_m_a_n_d
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _a_r_s_h_e_l_l is an array-cognizant variation of the standard _r_s_h(1C) command:
  16.      it connects to the specified _h_o_s_t and executes the specified _c_o_m_m_a_n_d.
  17.      For the purposes of parsing the _a_r_s_h_e_l_l command line, _h_o_s_t (optionally
  18.      prepended with _u_s_e_r_n_a_m_e) is considered to be the first argument that does
  19.      not being with the character "-", and _c_o_m_m_a_n_d is considered to be the
  20.      second such argument, as well as all of the arguments following it.
  21.  
  22.      _a_r_s_h_e_l_l copies its standard input to the remote command, the standard
  23.      output of the remote command to its standard output, and the standard
  24.      error of the remote command to its standard error.  Interrupt, quit and
  25.      terminate signals are propagated to the remote command; _a_r_s_h_e_l_l normally
  26.      terminates when the remote command does.  If the ----nnnn option is specified,
  27.      the remote command's standard input is taken from /dev/null instead of
  28.      _a_r_s_h_e_l_l's standard input; this can be useful if you intend to put _a_r_s_h_e_l_l
  29.      in the background under certain shells without redirecting its input away
  30.      from the terminal, since doing so may cause _a_r_s_h_e_l_l to block even if the
  31.      remote program does not try to read from its standard input.
  32.  
  33.      The remote username used is the same as your local username, unless you
  34.      specify a different remote name with the ----llll option or by using the
  35.      _u_s_e_r_n_a_m_e@_h_o_s_t format.  This remote name must be equivalent (in the sense
  36.      of _r_l_o_g_i_n(1C)) to the originating account; no provision is made for
  37.      specifying a password with a command.
  38.  
  39.      If you omit _c_o_m_m_a_n_d, you will be logged in on the remote host using
  40.      _r_l_o_g_i_n(1C) rather than _a_r_s_h_e_l_l itself.  In this case, arguments that are
  41.      unique to _a_r_s_h_e_l_l will be discarded while any additional arguments known
  42.      to _r_l_o_g_i_n (for example, ----LLLL) will be passed along.
  43.  
  44.      The connection to the remote machine is established using the array
  45.      services daemons on both the local and remote machines.  This allows
  46.      additional information, such as your array session handle on the local
  47.      machine, to be passed along to the remote machine.  If array services are
  48.      not available on either the local or remote machine, then an attempt will
  49.      be made to establish a connection using the normal _r_s_h(1C) command.
  50.      Thus, it is possible to use _a_r_s_h_e_l_l as a replacement for _r_s_h.  (However,
  51.      this should be done by placing _a_r_s_h_e_l_l earlier in the path than _r_s_h, nnnnooootttt
  52.      by replacing _r_s_h since _a_r_s_h_e_l_l may need to invoke _r_s_h).
  53.  
  54.      Shell metacharacters that are not quoted are interpreted on the local
  55.      machine, while quoted metacharacters are interpreted on the remote
  56.      machine.  Thus the command
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaarrrrsssshhhheeeellllllll((((1111))))                                                          aaaarrrrsssshhhheeeellllllll((((1111))))
  71.  
  72.  
  73.  
  74.           arshell otherhost cat remotefile >> localfile
  75.  
  76.      appends the remote file _r_e_m_o_t_e_f_i_l_e to the local file _l_o_c_a_l_f_i_l_e, while
  77.  
  78.           arshell otherhost cat remotefile ">>" otherremotefile
  79.  
  80.      appends _r_e_m_o_t_e_f_i_l_e to _o_t_h_e_r_r_e_m_o_t_e_f_i_l_e.
  81.  
  82. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  83.      These command line options are only relevant when both the local and
  84.      remote systems are running array services and will be discarded if the
  85.      command ends up being referred to _r_l_o_g_i_n or _r_s_h.  In addition to these
  86.      command line options, the standard command line options for _r_s_h and
  87.      _r_l_o_g_i_n are also accepted.
  88.  
  89.      _----_DDDD or _----_dddd_iiii_rrrr_eeee_cccc_tttt
  90.           Indicates that the request should be sent directly to the remote
  91.           machine, rather than forwarded to that machine by the local array
  92.           services daemon.  This will fail on systems that use array services
  93.           authentication unless the ----KKKKllll and ----KKKKrrrr options are also specified.
  94.           _----_DDDD is the default behavior under normal circumstances (but see the
  95.           description of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD variable, below).
  96.  
  97.      _----_FFFF or _----_ffff_oooo_rrrr_wwww_aaaa_rrrr_dddd
  98.           Indicates that the request should be forwarded to the remote machine
  99.           via the local array services daemon, rather than sent directly to
  100.           it.  _----_FFFF will become the default behavior if the value of the
  101.           _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD environment variable begins with the letter "Y" (as
  102.           in "yes"; it may be in either upper or lower case).
  103.  
  104.      _----_KKKK_llll _k_e_y or _----_llll_oooo_cccc_aaaa_llll_kkkk_eeee_yyyy _k_e_y
  105.           Use _k_e_y for the local authentication key when communicating directly
  106.           with the remote array services daemon.  _k_e_y is an unsigned 64-bit
  107.           value.  The default local key is obtained from the environment
  108.           variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______LLLL_OOOO_CCCC_AAAA_LLLL_KKKK_EEEE_YYYY; if that does not exist, no key is used.
  109.           The actual role played by _k_e_y depends on the authentication method
  110.           used by array services in a particular configuration.
  111.  
  112.      _----_KKKK_rrrr _k_e_y or _----_rrrr_eeee_mmmm_oooo_tttt_eeee_kkkk_eeee_yyyy _k_e_y
  113.           Use _k_e_y for the remote authentication key when communicating
  114.           directly with the remote array services daemon.  _k_e_y is an unsigned
  115.           64-bit value.  The default remote key is obtained from the
  116.           environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______RRRR_EEEE_MMMM_OOOO_TTTT_EEEE_KKKK_EEEE_YYYY; if that does not exist, no
  117.           key is used.  The actual role played by _k_e_y depends on the
  118.           authentication method used by array services in a particular
  119.           configuration.
  120.  
  121.      _----_llll _u_s_e_r_n_a_m_e
  122.           Specifies that the command should be executing using the account of
  123.           _u_s_e_r_n_a_m_e on the remote machine.  _u_s_e_r_n_a_m_e must be equivalent (in the
  124.           sense of _r_l_o_g_i_n(1C)) to your local userid.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaarrrrsssshhhheeeellllllll((((1111))))                                                          aaaarrrrsssshhhheeeellllllll((((1111))))
  137.  
  138.  
  139.  
  140.      _----_NNNN   Do nnnnooootttt revert to /usr/bsd/rsh if an array services daemon is not
  141.           found on the local and/or remote machine.  In this case, the command
  142.           will simply fail.
  143.  
  144.      _----_OOOO   Force usage of /usr/bsd/rsh.  Useful if _a_r_s_h_e_l_l has been placed in
  145.           the path before /usr/bsd with the name "rsh".  WWWWaaaarrrrnnnniiiinnnngggg:::: an infinite
  146.           loop will occur if /usr/bsd/rsh is _r_e_p_l_a_c_e_d by arshell!
  147.  
  148.      _----_pppp _p_o_r_t or _----_pppp_oooo_rrrr_tttt _p_o_r_t
  149.           Specifies the port address of the array services daemon on the
  150.           remote machine.  Defaults to the value of the "ARRAYD_PORT"
  151.           environment variable if present, or the standard port number of the
  152.           "sgi-arrayd" service otherwise.
  153.  
  154.      _----_ssss   Indicates that the rest of the command line should be treated as the
  155.           command to be executed on the remote machine.  This can be useful if
  156.           the command happens to look like an arshell option.
  157.  
  158. NNNNOOOOTTTTEEEESSSS
  159.      The file ////uuuussssrrrr////ssssbbbbiiiinnnn////aaaarrrrsssshhhheeeellllllll is actually a wrapper script that exec's the
  160.      binary ////uuuussssrrrr////lllliiiibbbb////aaaarrrrrrrraaaayyyy////bbbbiiiinnnn////aaaarrrrsssshhhheeeellllllll.  This allows the system administrator
  161.      to set standard options (e.g. ----FFFF) or override the actual binary that is
  162.      used.
  163.  
  164. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  165.      array(1), rsh(1C).
  166.  
  167. BBBBUUUUGGGGSSSS
  168.      If you are using _c_s_h(1) and put _a_r_s_h_e_l_l in the background without
  169.      redirecting its input away from the terminal, it blocks even if no reads
  170.      are posted by the remote command.  If no input is desired, you should use
  171.      the ----nnnn option, which redirects the input of _a_r_s_h_e_l_l to /_d_e_v/_n_u_l_l.
  172.  
  173.      You cannot run an interactive command (like _v_i(1)); use _r_l_o_g_i_n(1C).
  174.  
  175.      Job control signals stop the local _a_r_s_h_e_l_l process only; this is arguably
  176.      wrong, but currently hard to fix.
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.